home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2001 May / SGI IRIX Base Documentation 2001 May.iso / usr / share / catman / g_man / cat3 / OpenGL / glprioritizetextures.z / glprioritizetextures
Encoding:
Text File  |  2001-04-17  |  6.5 KB  |  133 lines
  1.  
  2.  
  3.  
  4. ggggllllPPPPrrrriiiioooorrrriiiittttiiiizzzzeeeeTTTTeeeexxxxttttuuuurrrreeeessss((((3333GGGG))))       OOOOppppeeeennnnGGGGLLLL RRRReeeeffffeeeerrrreeeennnncccceeee       ggggllllPPPPrrrriiiioooorrrriiiittttiiiizzzzeeeeTTTTeeeexxxxttttuuuurrrreeeessss((((3333GGGG))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      ggggllllPPPPrrrriiiioooorrrriiiittttiiiizzzzeeeeTTTTeeeexxxxttttuuuurrrreeeessss - set texture residence priority
  10.  
  11.  
  12. CCCC SSSSPPPPEEEECCCCIIIIFFFFIIIICCCCAAAATTTTIIIIOOOONNNN
  13.      void ggggllllPPPPrrrriiiioooorrrriiiittttiiiizzzzeeeeTTTTeeeexxxxttttuuuurrrreeeessss( GLsizei _n,
  14.                                 const GLuint *_t_e_x_t_u_r_e_s,
  15.                                 const GLclampf *_p_r_i_o_r_i_t_i_e_s )
  16.  
  17.  
  18. PPPPAAAARRRRAAAAMMMMEEEETTTTEEEERRRRSSSS
  19.      _n           Specifies the number of textures to be prioritized.
  20.  
  21.      _t_e_x_t_u_r_e_s    Specifies an array containing the names of the textures to be
  22.                  prioritized.
  23.  
  24.      _p_r_i_o_r_i_t_i_e_s  Specifies an array containing the texture priorities.  A
  25.                  priority given in an element of _p_r_i_o_r_i_t_i_e_s applies to the
  26.                  texture named by the corresponding element of _t_e_x_t_u_r_e_s.
  27.  
  28. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  29.      ggggllllPPPPrrrriiiioooorrrriiiittttiiiizzzzeeeeTTTTeeeexxxxttttuuuurrrreeeessss assigns the _n texture priorities given in _p_r_i_o_r_i_t_i_e_s
  30.      to the _n textures named in _t_e_x_t_u_r_e_s.
  31.  
  32.      The GL establishes a ``working set'' of textures that are resident in
  33.      texture memory.  These textures may be bound to a texture target much
  34.      more efficiently than textures that are not resident.  By specifying a
  35.      priority for each texture, ggggllllPPPPrrrriiiioooorrrriiiittttiiiizzzzeeeeTTTTeeeexxxxttttuuuurrrreeeessss allows applications to
  36.      guide the GL implementation in determining which textures should be
  37.      resident.
  38.  
  39.      The priorities given in _p_r_i_o_r_i_t_i_e_s are clamped to the range [0,1] before
  40.      they are assigned.  0 indicates the lowest priority; textures with
  41.      priority 0 are least likely to be resident.  1 indicates the highest
  42.      priority; textures with priority 1 are most likely to be resident.
  43.      However, textures are not guaranteed to be resident until they are used.
  44.  
  45.      ggggllllPPPPrrrriiiioooorrrriiiittttiiiizzzzeeeeTTTTeeeexxxxttttuuuurrrreeeessss silently ignores attempts to prioritize texture 0,
  46.      or any texture name that does not correspond to an existing texture.
  47.  
  48.      ggggllllPPPPrrrriiiioooorrrriiiittttiiiizzzzeeeeTTTTeeeexxxxttttuuuurrrreeeessss does not require that any of the textures named by
  49.      _t_e_x_t_u_r_e_s be bound to a texture target.  ggggllllTTTTeeeexxxxPPPPaaaarrrraaaammmmeeeetttteeeerrrr may also be used
  50.      to set a texture's priority, but only if the texture is currently bound.
  51.      This is the only way to set the priority of a default texture.
  52.  
  53. NNNNOOOOTTTTEEEESSSS
  54.      ggggllllPPPPrrrriiiioooorrrriiiittttiiiizzzzeeeeTTTTeeeexxxxttttuuuurrrreeeessss is available only if the GL version is 1.1 or
  55.      greater.
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. ggggllllPPPPrrrriiiioooorrrriiiittttiiiizzzzeeeeTTTTeeeexxxxttttuuuurrrreeeessss((((3333GGGG))))       OOOOppppeeeennnnGGGGLLLL RRRReeeeffffeeeerrrreeeennnncccceeee       ggggllllPPPPrrrriiiioooorrrriiiittttiiiizzzzeeeeTTTTeeeexxxxttttuuuurrrreeeessss((((3333GGGG))))
  71.  
  72.  
  73.  
  74. ERRORS
  75.      GGGGLLLL____IIIINNNNVVVVAAAALLLLIIIIDDDD____VVVVAAAALLLLUUUUEEEE is generated if _n is negative.
  76.  
  77.      GGGGLLLL____IIIINNNNVVVVAAAALLLLIIIIDDDD____OOOOPPPPEEEERRRRAAAATTTTIIIIOOOONNNN is generated if ggggllllPPPPrrrriiiioooorrrriiiittttiiiizzzzeeeeTTTTeeeexxxxttttuuuurrrreeeessss is executed
  78.      between the execution of ggggllllBBBBeeeeggggiiiinnnn and the corresponding execution of
  79.      ggggllllEEEEnnnndddd.
  80.  
  81. AAAASSSSSSSSOOOOCCCCIIIIAAAATTTTEEEEDDDD GGGGEEEETTTTSSSS
  82.      ggggllllGGGGeeeettttTTTTeeeexxxxPPPPaaaarrrraaaammmmeeeetttteeeerrrr with parameter name GGGGLLLL____TTTTEEEEXXXXTTTTUUUURRRREEEE____PPPPRRRRIIIIOOOORRRRIIIITTTTYYYY retrieves the
  83.      priority of a currently bound texture.
  84.  
  85.  
  86. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  87.      ggggllllAAAArrrreeeeTTTTeeeexxxxttttuuuurrrreeeessssRRRReeeessssiiiiddddeeeennnntttt, ggggllllBBBBiiiinnnnddddTTTTeeeexxxxttttuuuurrrreeee, ggggllllCCCCooooppppyyyyTTTTeeeexxxxIIIImmmmaaaaggggeeee1111DDDD, ggggllllCCCCooooppppyyyyTTTTeeeexxxxIIIImmmmaaaaggggeeee2222DDDD,
  88.      ggggllllTTTTeeeexxxxIIIImmmmaaaaggggeeee1111DDDD, ggggllllTTTTeeeexxxxIIIImmmmaaaaggggeeee2222DDDD, ggggllllTTTTeeeexxxxIIIImmmmaaaaggggeeee3333DDDD, ggggllllTTTTeeeexxxxPPPPaaaarrrraaaammmmeeeetttteeeerrrr
  89.  
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.